home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / midi / midifl12.lha / midifile.new / README < prev   
Text File  |  1995-08-27  |  4KB  |  94 lines
  1. This directory contains a library of code to read and write standard 
  2. MIDI files, a standard as defined by the MMA, the MIDI Manufacturer's
  3. Assocation. The format spec is available from the IMA:
  4.  
  5.                 International MIDI Association
  6.                 5316 West 57th Street
  7.                 Los Angeles, CA 90056
  8.  
  9.  
  10. "make mftext" will compile a program that gives a verbose textual
  11. listing of a MIDI file, and is an example of how to read a file.  "make
  12. mf1to0" will compile a program that demonstrates how to write midi
  13. files, and converts format 1 multitrack files to format 0.  "make
  14. midifile.man" will produce a formatted manual page.  Example MIDI files
  15. are named "example*.uu".  They're uuencoded; "make uutomid" will
  16. uudecode them all.  The first two examples (example1 and example2) are
  17. the examples given in the 0.06 version of the standard MIDI file
  18. specification.
  19.  
  20.             ...Tim Thompson...att!twitch!glimmer!tjt...
  21.  
  22. June, 1989 - Added code to write midi files and the mf1to0 program.
  23.          Michael Czeiszperger  czei@pan.com
  24.  
  25. Notes on Porting:
  26. This library was written on UNIX, and tested on Sun's, PC's and Mac's.  
  27. It is distributed in a raw vanilla state, which means you may have to do a 
  28. little editing depending on the requirements of your particular development 
  29. system.  For instance, with THINK C on the Mac, you have to be careful 
  30. and include all the include files needed by their implementation of 
  31. UNIX calls such as malloc().  I've left in the proper calls ifdef'd on
  32. THINK so you'll have a clue what to do. 
  33.  
  34. czei@pan.com
  35.  
  36. -------------------------------------------------------------------------------
  37.  
  38. This code was ported from the orginal sources to Commodore Amiga system by
  39.                  
  40.                                  Andreas Jung
  41.                                 Klosterstr. 21
  42.                          D-66125 Saarbruecken, Germany
  43.                            Email: ajung@cs.uni-sb.de
  44.  
  45.  
  46. The following changes were made:
  47.  
  48.  - beautified the sources using indent
  49.  - removed most of the K&R declarations and replace them by ANSI declarations
  50.  - fixed sources to use with DICE Professional
  51.  
  52. This package is distributed "as-is" under the GNU Public License.
  53.  
  54. I used part of the code in my program MIDI PERFORMANCE MANAGER - MPM. It seems
  55. to work fine. No bugs were found yet. The code does *NOT* support MIDI format 2
  56. files, only format 0 and 1 is supported !
  57.  
  58. ---------------------------------------------------------------------------------
  59.  
  60. History: 
  61.  
  62. V 1.0 Initial Amiga release
  63. V 1.1 Fixed bug in header file
  64. V 1.2 Updated archive with the sources of midifile V 1.11:
  65.  
  66.      (1) can now set the global variable Mf_interactive to 1 to prevent the
  67.          reading functions from looking for file and track headers
  68.      (2) can now write system exclusive data with
  69.          mf_write_midi_event(delta_time, system_exlusive, 0, data, size)
  70.      (3) changed definition of 'sequencer_specific' in midifile.h to 0x7f
  71.      (4) changed mf_write_tempo to take additional delta_time as first argument
  72.          (since delta need not be zero)
  73.      (5) added function mf_write_seqnum(unsigned long delta_time, unsigned seqnum)
  74.      (6) changed mf_write_midi_event to use running status
  75.      (7) removed the code to write an end of track meta event automatically
  76.          -- this must now be done by the user of the library (I changed
  77.          it because I need to be able to control the time delta of this
  78.           meta event)
  79.      (8) added global variables Mf_division, Mf_currtempo, Mf_realtime, which
  80.          are updated by the reading functions.  Mf_realtime is useful,
  81.          because Mf_currtime does not really measure time at all, since
  82.          its units change value at every tempo change.  Mf_realtime is
  83.          the midi-time elapsed in units of 1/16 of a centisecond (but it
  84.          does not handle smpte times)
  85.      (9) maintains a history of tempo settings to update Mf_currtempo,
  86.          to handle tempo tracks.
  87.      (10) if there is an Mf_error function, the error routine no longer
  88.          exits, leaving it to the application to do this.
  89.      (11) chanmessage skips over invalid c1 command bytes > 127 and
  90.          adjusts invalid c2 argument byte > 127 to 127.
  91.      (12) readmt returns EOF when it encounters a 0 or 0x1a byte instead of an 
  92.         expected header string (some midi files have padding at end).
  93.  
  94.